Cluster installation with installer

Start the installation on the first cluster node. The hostname of this cluster node is required when installing the other cluster nodes. The number of cluster nodes is not limited, but there must be at least three cluster nodes. You can install any IQ4docs components for each cluster node, but only the features MongoDB and RabbitMQ can be clustered. If these components are not selected, the dialog for the cluster installation is not displayed.

In the Cluster Installation dialog, select that a cluster installation is to be performed (by selecting the Cluster Installation checkbox). In the lower part of the dialog select whether the cluster installation should be performed for MongoDB and/or RabbitMQ (usually both).

Specify the hostname of the first cluster node. Specify the name as it is output by the name server (for example, in a reverse lookup). If the specified name matches the current hostname, the installer automatically sets this installation as the first cluster node. For all cluster nodes, you must always enter the hostname of the first cluster node.

The hostname must be the same for all cluster nodes (always the hostname of the first cluster node).

Specify a key-like, random string of letters and numbers (between 6 and 1024 characters) here, for example:

• w4u5zoawer9wz78raow83zoawze2ri6uazvbuiwer

This key is used - exactly as entered - as a RabbitMQ cookie and in the MongoDB key file. Enter the exact same key for all cluster nodes.

The key must match exactly for all cluster nodes to be installed.

Manual adaptations still need to be made after the installation of all cluster nodes.

• In the LocalService.config of the ConfigService of all cluster nodes, specify the hostnames of all cluster nodes (separated by commas) for MongoDbHost and RabbitMQHost. You will find the file in the installation directory in the subdirectory ConfigService (e.g. C:\Printsystem 4\ConfigService\LocalService.config).
  • <add key="MongoDbHost" value="server1,server2,server3"/>

  • <add key="RabbitMqHost" value="server1,server2,server3"/>

• Specify the new cluster node in the Server (Cluster Nodes) area in the system area, see System Areas.

After the cluster installation and modification of the configuration, restart all cluster nodes one after the other. Always only restart one cluster node first and wait until the cluster has been reestablished. Then restart the next cluster node.

Do not restart all cluster nodes simultaneously.